.Dd Jul 21, 2017
.Dt TKPLAY 1
.Os
.Sh NAME
.Nm tkplay
.Nd a simple GUI for
.Xr auplayer 1
.Sh SYNOPSIS
.Nm
.Op Fl lprsv
.Op Fl F Ar file-descriptor
.Op Fl b Ar buffer-size
.Op Fl c Ar command
.Op Fl d Ar device
.Op Fl f Ar file-list
.Op Fl h Ar history-size
.Ar
.Sh DESCRIPTION
.Nm
provides a simple GUI interface for playing audio files.
.Pp
The arguments are as follows:
.Bl -tag -width Ds
.It Fl F Ar file-descriptor
Add lines read from
.Ar file-descriptor
to the playlist as below, removing leading & trailing white-space.
File-descriptor
.Li 3
can not be used.
.It Fl b Ar buffer-size
Specify the buffer size for
.Xr auopen 1 .
.br
Additionally, append
.Qq Fl b Ar buffer-size
to the end of the shell command string.
.It Fl c Ar command
Specify the shell command to execute when playing audio.
.It Fl d Ar device
Append
.Qq Fl d Ar device
to the end of the shell command string.
.It Fl f Ar file-list
Add each line of
.Ar file-list
to the playlist as below, removing leading & trailing white-space.
.It Fl h Ar history-size
Specify the number of elements to keep in history.
.It Fl l
After playing the last file loop back to the beginning instead of
exiting, reshuffling if
.Fl s
is specified.  This option has no effect if
.Fl r
is specified.
.It Fl r
Play the audio files in a random order.
.It Fl s
Shuffle the list of audio files.
.It Ar
Append
.Ar file
to the list of files.  If it is a directory, non-recursively append its,
sorted, entries to the list of files.
.El
.Sh COMMANDS
The available keyboard commands are as follows:
.Bl -tag -width Ds
.It Sy D
Remove the current directory from the playlist.
.It Sy d
Remove the current entry from the playlist.
.It Sy h
Go back to the previous playlist entry.
.It Sy j
A synonym for
.Sy h .
.It Sy k
Go to the next playlist entry.
.It Sy l
A synonym for
.Sy k .
.It Sy p
Toggle the pause state.
.It Sy q
Exit
.Nm .
.It Sy r
Replay the current entry.
.El
.Sh EXIT STATUS
.Ex -std
.Sh SEE ALSO
.Xr auplayer 1
.Xr auopen 1
.Xr au2dev 1
